home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / dmjgif3.lzh / DMJ_GIFþ.MAN < prev    next >
Text File  |  1991-11-04  |  68KB  |  1,545 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.             //////////////////////////////////////////////////////
  9.             ///////////    // /// ////  /////    //  /     ///////
  10.             //////////  /  /  /  ////  ////  /////  /  ///////////
  11.             /////////  /  /     ////  ////  /   /  /    //////////
  12.             ////////  /  /  /  /  /  ////  //  /  /  /////////////
  13.             ///////    //  /  //   //////    //  /  //////////////
  14.             //////////////////////////////////////////////////////
  15.  
  16.                                   Version 3.0
  17.  
  18.                               by Damien M. Jones
  19.  
  20.                                October 31, 1991
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.          DMJ GIF Program and Manual Copyright © 1991 Damien M. Jones.
  60.                              All Rights Reserved.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                                                                 Page 2
  73.  
  74.          Copyright Notice
  75.  
  76.          DMJ GIF, its companion utilities, and this manual are all
  77.          Copyright 1991 Damien M. Jones, All Rights Reserved.  You may
  78.          copy unregistered versions of the program as you wish as long
  79.          as all of the files listed in the file READTHIS.1ST are
  80.          included.  You may not charge for these copies, except
  81.          reasonable charges to cover the acquisition of the program
  82.          and the media it is distributed on (as in Public
  83.          Domain/Shareware distributors).  This charge should not
  84.          exceed $10.  Registered copies of DMJ GIF should not be
  85.          copied except for your own personal use.  The rule of thumb
  86.          here is multiple copies on one computer, or one copy on
  87.          multiple computers (although not simultaneously).  You may
  88.          sell your registered copy of DMJ GIF, but your printed manual
  89.          must accompany the sale, and new owners should send their
  90.          program disk back to register the change of ownership, or
  91.          they will not receive updates.
  92.  
  93.  
  94.          Shareware Notice
  95.  
  96.          This program is Shareware.  If you like it and use it, please
  97.          send $15 to the address on the front cover.  In return for
  98.          registering this program, you will receive a printed manual
  99.          and the latest registered version of DMJ GIF.  Registered
  100.          versions of DMJ GIF are almost twice as fast as unregistered
  101.          versions, and are not to be distributed.  You'll also receive
  102.          free updates to the program as they become available.
  103.  
  104.  
  105.          About this Manual
  106.  
  107.          If you've used DMJ GIF before, you'll notice that this is a
  108.          new manual.  You should be able to skip the introduction, but
  109.          be sure to read the rest of the manual before trying to use
  110.          DMJ GIF.  It's a completely different program now; you'll be
  111.          in for a surprise or two.
  112.  
  113.          This text for this manual was created with ST Writer Elite
  114.          4.2.
  115.  
  116.  
  117.          About the Programs
  118.  
  119.          The programs DMJ GIF, SPC2PI1, SPC2PI3, SPU2SPC, and SPC-3375
  120.          were all written in GFA BASIC 3.07, with portions written in
  121.          assembly.  The code is entirely mine, except for the Spectrum
  122.          display and decompression routines.  Thanks to Trio for
  123.          writing those two and releasing them to the public.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                                                                 Page 3
  140.  
  141.          Table of Contents
  142.  
  143.  
  144.                Introduction .   .   .   .   .   .   .   .   .  4
  145.                Running DMJ GIF    .   .   .   .   .   .   .    5
  146.                The Main Dialog  .   .   .   .   .   .   .   .  5
  147.                Converting a GIF   .   .   .   .   .   .   .    6
  148.                The Custom Fileselector  .   .   .   .   .   .  8
  149.                Batch Conversions  .   .   .   .   .   .   .   11
  150.                ST Resolution GIFs   .   .   .   .   .   .   . 13
  151.                Conversion Types   .   .   .   .   .   .   .   13
  152.                Dithering    .   .   .   .   .   .   .   .   . 14
  153.                Palettes   .   .   .   .   .   .   .   .   .   14
  154.                Scaling  .   .   .   .   .   .   .   .   .   . 15
  155.                Mapping    .   .   .   .   .   .   .   .   .   16
  156.                Interlaced GIFs  .   .   .   .   .   .   .   . 18
  157.                Keyboard Shortcuts .   .   .   .   .   .   .   18
  158.                Preferences  .   .   .   .   .   .   .   .   . 19
  159.                Bugs   .   .   .   .   .   .   .   .   .   .   20
  160.                Feedback .   .   .   .   .   .   .   .   .   . 21
  161.                The Companion Utilities    .   .   .   .   .   21
  162.                Thanks...    .   .   .   .   .   .   .   .   . 23
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.                                                                 Page 4
  204.  
  205.          Introduction
  206.  
  207.          Great.  You've managed to get your hands on DMJ GIF,
  208.          undoubtedly the best non-commercial GIF to Spectrum converter
  209.          available. This program also allows you to convert entire
  210.          batches of GIF's at once, without your supervision.  It
  211.          allows you to convert to Spectrum, DEGAS, or Tiny, in color,
  212.          grey scale, or monochrome, using either the ST's regular
  213.          palette or the STe's enhanced palette, converting ANY size
  214.          GIF--and it runs in only a half meg.
  215.  
  216.          If you don't know what a GIF file is, well, it's a picture
  217.          format developed by CompuServe as a sort of standard.  Since
  218.          many different computers can create and use pictures in this
  219.          format, and because of the efficient compression used to save
  220.          space, this is an ideal format for exchanging pictures via
  221.          bulletin board systems.  It doesn't matter what kind of
  222.          computer the picture was created on, because the GIF standard
  223.          doesn't care.  Neither does your ST.  Well, not too much,
  224.          that is.
  225.  
  226.          The ST has three different graphics resolutions it can use.
  227.          There is low resolution, which is 320x200x16; there's medium
  228.          resolution, which is 640x200x4; and there is high resolution,
  229.          which is 640x400 in monochrome.  The problem arises in that
  230.          most GIF pictures don't fit nicely into one of the ST's
  231.          resolutions.  A lot of them are 640x350x16, or 320x200x32, or
  232.          640x480x256.  And while the ST has 512 colors it can choose
  233.          from (the palette size), most GIF pictures use a much larger
  234.          palette--allowing them much greater detail in colors.
  235.  
  236.          A few years ago, some very, very clever programmers devised a
  237.          way to put all 512 of the ST's colors on the screen at one
  238.          time.  So they effectively added a fourth graphics resolution
  239.          to the ST: Spectrum mode, or 320x200x512.  Although the pixel
  240.          resolution is the same as low resolution, and the palette
  241.          size is still only 512 colors, these colors can be mixed, or
  242.          "dithered", to make it look like there are a lot more on the
  243.          screen.  This wouldn't be possible unless there were fewer
  244.          restrictions on using colors; 16 colors just isn't enough to
  245.          do the dithering that DMJ GIF does.
  246.  
  247.          DMJ GIF is not the first program that converts GIF pictures
  248.          to Spectrum pictures.  But this program excels in its
  249.          handling of pictures that are larger than the ST's low
  250.          resolution of 320x200.  Here's why: most programs (or should
  251.          I say, every single program I've ever used except the
  252.          Spectrum paint program itself) don't scale things very well.
  253.          Let's say, for example, that you want to convert a picture
  254.          that's 640x400x16 colors down to a picture that's
  255.          320x200x512.  What you'd do is divide the entire screen up
  256.          into little squares--each square being 2x2 pixels.  Most
  257.          programs look at each little square and pick one of the
  258.          points, assuming it best represents the entire square.
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.                                                                 Page 5
  270.  
  271.          That's usually no problem, but if you've got a lot of
  272.          patterns and "dithering", then you DO have a problem, because
  273.          you're leaving out 75% of the detail while preserving the
  274.          other 25%.  What you end up with is usually a mess.
  275.  
  276.          This program takes a different approach.  Instead of just
  277.          picking one pixel from that 2x2 square, it determines the
  278.          overall color by averaging the colors of the pixels.  (That's
  279.          why you need 512 colors--when you start averaging 16 colors
  280.          with different amounts of each one, the number of colors gets
  281.          big, fast.)  Of course, with fantastic results there comes a
  282.          price.  The price with this program is speed.  Because of the
  283.          averaging and the floating point (read "slow") arithmetic,
  284.          this program takes a while to run.  But the results are WELL
  285.          worth the wait.  And registered versions of DMJ GIF are much
  286.          faster.
  287.  
  288.  
  289.          Running DMJ GIF
  290.  
  291.          To run DMJ GIF, all you have to do is double-click on
  292.          DMJ_GIF.TOS from the Desktop in medium resolution.  You'll
  293.          need at least 340K free; if you have only 512K I'd strongly
  294.          suggest stripping out all your accessories and AUTO folder
  295.          programs, since the more memory DMJ GIF has, the better it
  296.          works.  And even when you do this, you won't be able to
  297.          convert a GIF directly to DEGAS/Tiny format in full color
  298.          with only 512K, since this direct conversion uses a 96K
  299.          buffer...
  300.  
  301.          Once you have the program loaded, you'll see a small dialog
  302.          telling you this program is an unregistered version of the
  303.          program.  If you get a dialog thanking you for registering
  304.          the program, and you haven't, then you have a pirate copy of
  305.          the registered version.  Please destroy it immediately!
  306.  
  307.  
  308.          The Main Dialog
  309.  
  310.          The first rule of thumb when using DMJ GIF is not to freak
  311.          when you see the main dialog.  There's a lot of things there;
  312.          DMJ GIF is a powerful program, and there's no easy way of
  313.          putting all of that power at your fingertips and yet making a
  314.          program easy to use.  Fortunately, however, help is always at
  315.          your fingertips--just press the HELP key on your ST's
  316.          keyboard, and you'll receive complete help without ever
  317.          leaving the program.  (You will need the file DMJ_GIF3.HLP in
  318.          the same folder as DMJ GIF, however; see above.)
  319.  
  320.          The dialog is divided into five main sections.  These are
  321.          "Stuff", "Files", "Control", "Options", and "Info".  In the
  322.          "Stuff" section you will find three buttons, "Help", "Info",
  323.          and "Quit".  "Help" will allow you to enter the help system;
  324.          it has the same effect as pressing the HELP key.  "Info"
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.                                                                 Page 6
  336.  
  337.          brings up some information about the program, such as
  338.          version, date, and who the program is registered to.  "Quit"
  339.          is used to exit the program; you will be asked if you are
  340.          sure.
  341.  
  342.          In the "Files" box you will see space for two filenames.  One
  343.          is "From", which is the source file, and the other is "To",
  344.          which is the destination file.
  345.  
  346.          In the "Control" box are the buttons that tell DMJ GIF what
  347.          you want done.  The buttons here are "Begin", "Add",
  348.          "Remove", "Save", and "View".  You'll also see a space
  349.          labeled "Pictures"; this tells you how many pictures DMJ GIF
  350.          has stored in its batch list.  Beneath that you will see a
  351.          slider, which lets you move to any picture in the list.
  352.  
  353.          In the "Options" box are all the settings on how to convert a
  354.          GIF.  You'll find five "Dither" buttons, four "Palette"
  355.          buttons, and also "Map", "Guess", "Exact", "Type", "Skip",
  356.          and "Prefs".
  357.  
  358.          In the "Info" box you'll see blanks for "Image Size",
  359.          "Palette Size", and "Colors".  You'll also see a button
  360.          labeled "More", which brings up a lot more information about
  361.          the current picture.
  362.  
  363.  
  364.          Converting a GIF
  365.  
  366.          Despite appearances (that main dialog can be quite
  367.          intimidating) converting a GIF is not actually that
  368.          difficult.  To begin with, you need to tell DMJ GIF just what
  369.          file you want to convert.  So grab the mouse and click on the
  370.          "From" filename in the upper right hand corner of the dialog.
  371.          A file selector will appear, allowing you to choose a GIF
  372.          file.  (If you have trouble with the custom file selector,
  373.          you can either press HELP, or read the section below on the
  374.          custom file selector.)  Just choose the GIF picture you want
  375.          to convert, and then click on "Okay".  You'll then see a
  376.          small status display in the center of the screen, tell you it
  377.          is "Analyzing" a file.  This just means DMJ GIF is looking at
  378.          the GIF to find out how it should convert it.  For most
  379.          pictures this is reasonably fast; for 256-color VGA pictures
  380.          it takes about eight seconds.
  381.  
  382.          That step completed, you will find several things have
  383.          happened: first, the "To" file has been changed to almost the
  384.          same as the "From"--the only difference being the last three
  385.          letters.  This is called the extension.  For a GIF picture,
  386.          the extension is "GIF"; for a Spectrum picture, it's "SPC" or
  387.          "SPU".  "SPC" is compressed form, which saves disk space.
  388.          "SPU" is uncompressed form.
  389.  
  390.          Another change is that the blanks in the "Info" area have
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.                                                                 Page 7
  402.  
  403.          suddenly been filled.  Don't worry about that now; that
  404.          information just describes the GIF picture you've selected.
  405.  
  406.          The last change is that one of the "Dither" buttons in the
  407.          "Options" section has been selected, as has one of the
  408.          "Current Palette" buttons.  Don't worry about that yet
  409.          either.
  410.  
  411.          All you have to do now is select the "Begin" button in the
  412.          "Control" section of the dialog.  DMJ GIF will begin
  413.          converting the picture from GIF format to Spectrum format.
  414.          This can take some time, so don't panic when it isn't
  415.          finished in the blink of an eye.  When the entire conversion
  416.          is done, DMJ GIF will save the picture to the disk.
  417.  
  418.          While DMJ GIF is busy, you'll see a small status display in
  419.          the middle of the screen.  It will tell you what DMJ GIF is
  420.          doing, and approximately how much of that task it has already
  421.          completed.  "Analyzing" refers to two things: first, when a
  422.          GIF is first read, its palette must be analyzed to determine
  423.          the proper amount of dithering.  Second, it refers to
  424.          analyzing the colors of a converted picture to determine
  425.          which colors to use.  "Reading" refers to the simple task of
  426.          loading the picture from the disk.  "Uncompressing" refers to
  427.          the task of uncompressing a picture.  For most GIFs this is
  428.          done during "Scaling", but interlaced GIFs must be
  429.          uncompressed first; Mapped pictures must also be partially
  430.          uncompressed.  ST format pictures (Spectrum, Tiny, and DEGAS
  431.          Elite) must also be uncompressed before being viewed.
  432.          "Scaling" refers to the time-consuming process of reducing
  433.          and averaging the picture to the proper size.  "Plotting"
  434.          refers to the actual process of plotting the picture; this is
  435.          usually done at the same time as "Scaling".  "Compressing"
  436.          refers to the task of compressing the picture prior to saving
  437.          it, and "Writing" refers to the actual saving to disk of the
  438.          picture.  Note that not all of these steps need appear for
  439.          any single picture; usually all you'll see during the actual
  440.          conversion are "Reading", "Scaling", "Compressing", and
  441.          "Writing".
  442.  
  443.          You can abort the conversion at any time by pressing any key;
  444.          a small dialog will appear, giving you three choices.  The
  445.          first one, "Abort", will end the conversion and return you to
  446.          the main dialog.  The second option, "Peek", will allow you
  447.          to look at the picture--at least, as much of it as has been
  448.          converted.  Press any key to return to the conversion.  The
  449.          last option, "Cancel", will simply return you to the
  450.          conversion.  (If the "Peek" option does not appear, that's
  451.          because the picture is not yet in ST displayable form.  You
  452.          can "Peek" at any picture while it is in the "Scaling" phase,
  453.          except Full Color conversions to Low Resolution
  454.          (non-Spectrum), in which case you must wait for the
  455.          "Plotting" phase.)
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.                                                                 Page 8
  468.  
  469.          See?  That wasn't so hard.  All of those other
  470.          options--reduction factors, dithering, and filename--are
  471.          automatically selected by DMJ GIF.  Most of the time you
  472.          won't have to worry about any of them.  About the only one
  473.          you might want to change is the "Destination" file.  All you
  474.          have to do to change that is to click on it, and a file
  475.          selector will appear, allowing you to choose the name for the
  476.          destination file.  Remember that this should end in either
  477.          ".SPC" (for a compressed picture) or ".SPU" (for an
  478.          uncompressed picture).  If it doesn't, DMJ GIF will restore
  479.          the extension you previously had.  (If you're not converting
  480.          to a Spectrum picture, then you won't be using ".SPC" or
  481.          ".SPU" as the extension.  See "Conversion Types" for more
  482.          information.)
  483.  
  484.  
  485.          The Custom Fileselector
  486.  
  487.          DMJ GIF uses a custom file selector.  It's really quite
  488.          simple to use.  If you have an alternate file selector loaded
  489.          (like the Universal Item Selector, or the Little Green
  490.          Selector) you won't be able to use it.
  491.  
  492.          At the top of the file selector is a line of text telling you
  493.          what file you're supposed to be selecting with the file
  494.          selector.  By "grabbing" this bar with the mouse (i.e. move
  495.          the pointer to it, press, and hold the left button down) you
  496.          can drag the entire file selector to a new spot on the
  497.          screen.  The file selector will appear at this same spot
  498.          every time you use it, until you leave the program.
  499.  
  500.          Below this line, you will see a line of text containing the
  501.          pathname.  You cannot change this line directly.  More on
  502.          this later.
  503.  
  504.          Below the pathname is the major component of the file
  505.          selector: the filenames.  This large white box contains up to
  506.          24 filenames at a time.  To select a filename, just click on
  507.          it.  Then click on the "Okay" button, which you will find in
  508.          the lower right hand corner of the file selector.  You can
  509.          also just double-click on the filename and skip clicking on
  510.          the "Okay" button; it will do the same thing.
  511.  
  512.          Below the white filename box you will see the name of the
  513.          currently selected file.  This filename can be edited with
  514.          the keyboard.  You can use the left and right arrow keys,
  515.          BACKSPACE, and DELETE to edit this filename.  You will not be
  516.          able to enter an illegal filename.  You can press ESC to
  517.          erase the filename completely; CTRL and the left or right
  518.          arrow key will move the cursor to the beginning and end of
  519.          the filename, respectively.
  520.  
  521.          In the lower right hand corner of the file selector you will
  522.          find two buttons, "Okay" and "Cancel".  Selecting "Okay"
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.                                                                 Page 9
  534.  
  535.          confirms the choice listed in the "Filename" area in the
  536.          lower left hand corner of the file selector.  Selecting
  537.          "Cancel" aborts this selection process.  Pressing RETURN on
  538.          the keyboard is the same as selecting "Okay"; pressing UNDO
  539.          is the same as selecting "Cancel".
  540.  
  541.          Directly to the right of the white filename box is a vertical
  542.          slider.  This is only useful when there are more than 24
  543.          files in the current folder.  You can use the up and down
  544.          arrow buttons to scroll the names; you can click above or
  545.          below the slider itself to move the slider in that direction
  546.          quickly; or you can drag the slider to a new position
  547.          directly.
  548.  
  549.          You may have noticed some of the files in the white filename
  550.          box have a small > symbol to their left.  These aren't files;
  551.          they are folders.  You can click on a folder's name (just
  552.          once) to change the current folder and see what's inside it.
  553.          The pathname line directly above the white filename box will
  554.          reflect the change--the new folder name will be added on the
  555.          end.  To exit back out of the folder, you can either select
  556.          the "<-" button in the upper right hand corner of the file
  557.          selector, or click on the part of the pathname that you want
  558.          to go to.  For example, if your current folder is
  559.          "D:\PICTURES\GIF\" and you wanted to go back to the PICTURES
  560.          folder, you could either select the "<-" button, or click on
  561.          the word "PICTURES" in the pathname line.  You can jump back
  562.          several folders at a time with just one click.  In the
  563.          example above, you could click on "D:\" and go to the main
  564.          directory of the disk, whereas it would take two clicks of
  565.          the "<-" button to do the same.
  566.  
  567.          There are three other buttons in the upper right hand corner
  568.          of the file selector.  One has a drive letter on it; another
  569.          has a disk icon on it; the third has "*.*" on it.  The drive
  570.          letter button allows you to quickly change the current drive.
  571.          Just click and hold the mouse button down on the drive
  572.          letter.  Move the mouse pointer to the drive you want to use,
  573.          and release the mouse button.  You will not be able to select
  574.          a drive that does not exist--this also means drive B:, so if
  575.          you have a single floppy drive, forget about drive B:.
  576.  
  577.          The disk icon button serves no other purpose but to tell the
  578.          file selector that you have inserted another disk, and you
  579.          would like to reread the disk's directory.
  580.  
  581.          The "*.*" icon, however, will require some explanation.  This
  582.          button calls up another dialog that allows you to select the
  583.          "search mask".  The search mask is how you tell the file
  584.          selector which files you want to see in the white filename
  585.          box.  You shouldn't normally need to use this.  Before
  586.          explaining about the search mask dialog, a little explanation
  587.          about search masks themselves is necessary.  Search masks are
  588.          just filenames with wildcards in them.  There are two
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.                                                                 Page 10
  600.  
  601.          wildcard characters that are used: the asterisk (*) and the
  602.          question mark (?).  The question mark represents any
  603.          letter--but only one letter.  The asterisk represents any
  604.          number of letters.  Here's some examples to make things
  605.          clearer: the wildcard PIC?.SPC would match PIC1.SPC,
  606.          PIC2.SPC, and PICZ.SPC, but not PIX1.SPC, PIC.SPC, or
  607.          PIC23.SPC.  The wildcard PIC*.SPC would match PIC1.SPC,
  608.          PIC2.SPC, PICZ.SPC, PIC.SPC, PIC23.SPC, and PICTURE.SPC, but
  609.          not PIX1.SPC or PIXELS.SPC.  See?  That's why the wildcard
  610.          "*.*" is used to mean all files--because it matches all
  611.          filenames.  Any number of characters, of any type, match the
  612.          first *.  Then there's the period, which separates the name
  613.          from the extension.  The last * matches any extension, no
  614.          matter how long it is.  The catch here is that GEMDOS takes a
  615.          shortcut when it comes to "*.*".  That wildcard shouldn't
  616.          match the filename "TEST", because it doesn't have a period
  617.          in it.  But because GEM doesn't actually record the period on
  618.          the disk, it assumes it is there.  So when GEMDOS checks for
  619.          files, "TEST" comes out to be "TEST.", and so fits the
  620.          wildcard.
  621.  
  622.          You've undoubtedly used wildcards before.  In the GEM File
  623.          Selector, the wildcard appears at the end of the pathname.
  624.          Many programs make use of wildcards to mask out files you
  625.          don't need to worry about.  For example, when selecting a
  626.          picture from SPC-3375, it uses a search mask of *.SP?.  This
  627.          allows all files to appear in the GEM File Selector, as long
  628.          as the first two letters of the extension are "SP".  So
  629.          anything with an extension of "SPC" and "SPU" will show up.
  630.          Unfortunately, anything with an extension of "SPX" or "SPQ"
  631.          will also show up.  It would be nice if there was an easy way
  632.          to allow only the extensions "SPC" and "SPU".
  633.  
  634.          The DMJ GIF file selector allows you to do just that.  It
  635.          allows you to take several wildcards and chain them together
  636.          to make one mask; a file only needs to fill one of the
  637.          wildcards to appear in the white filename box.  You separate
  638.          wildcards with the vertical bar character, |.  So to display
  639.          just Spectrum pictures, you'd use the mask "*.SPC|*.SPU",
  640.          instead of the less precise "*.SP?".
  641.  
  642.          Now that the enhanced wildcards have been explained, I can
  643.          explain how to use the "*.*" dialog.  You will see ten lines
  644.          in the dialog, each with a different search mask.  To select
  645.          one of these search masks, just select its button, which can
  646.          be found at the left side of the dialog.  You can select "Ok"
  647.          to confirm your choice, or double-click on your choice to
  648.          avoid the "Ok" button.  You can press F1-F10 in place of
  649.          click on the selection buttons, and you can press RETURN in
  650.          place of clicking on the "Ok" button.  If you want to change
  651.          one of the search masks, click on the mask you want to
  652.          change.  Then use the arrow keys, BACKSPACE, and DELETE to
  653.          edit the search mask on that line.  Remember that simply
  654.          editing a mask does not select it; you must choose its button
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.                                                                 Page 11
  666.  
  667.          on the left hand side.  Also note that you cannot edit the
  668.          top two lines.  These are reserved.  The top line has the
  669.          mask provided when the fileselector was called up; the second
  670.          line has the catch-all "*.*".
  671.  
  672.          This file selector is new and different, yes.  But once you
  673.          learn how to use it (and it won't take very long at all) you
  674.          won't even notice it.  You'll find this selector appearing in
  675.          more dmj software programs in the future, so you won't have
  676.          to learn a new file selector for my other programs.
  677.  
  678.  
  679.          Batch Conversions
  680.  
  681.          DMJ GIF does not have a separate "batch" mode; every time you
  682.          convert a single picture, you are actually converting a batch
  683.          of pictures, even though it is only one picture.  If you want
  684.          to convert a group of pictures, there are two ways to do it.
  685.          One way is to select a wildcard for the "From" file, like
  686.          "*.*"; this will read every GIF in the selected folder.
  687.          Another way is to use the "Add" button; you can then add
  688.          single files or more wildcards, even in separate folders and
  689.          separate drives.  DMJ GIF keeps its picture list in
  690.          alphabetical order, including the entire pathname.  So
  691.          pictures on drive A are sorted before pictures on drive C.
  692.  
  693.          Once you have more than one picture in the list, you'll see
  694.          the slider in the "Control" box change.  You can click on the
  695.          arrows next to the slider to move forward and backward
  696.          through the list, or you can drag the slider to a new
  697.          location.  Each picture has its own dither, palette, and
  698.          scaling settings, and its own destination file.
  699.  
  700.          If you click on the "To" filename and change the folder to
  701.          save the picture in, an alert box will pop up asking you if
  702.          you want to change the folders of the other pictures.  "All"
  703.          will change the folders of all the pictures to the same as
  704.          the one you just selected; "Match" will change only those
  705.          pictures that have the same path as the current picture
  706.          before it was changed.  "None" will change the path of none
  707.          of the other pictures.
  708.  
  709.          Perhaps an example will make this clearer.  Let's say you
  710.          have three pictures, BEARS.GIF, COBRA.GIF, and EAGLE.GIF, in
  711.          the folder ANIMALS.  You also have the pictures MAC2RAY.GIF
  712.          and MUSEUM.GIF in the folder RAYTRACE.  The default "To" name
  713.          for each of these pictures will be in the same folder as the
  714.          picture--ANIMALS\BEARS.GIF will be saved as
  715.          ANIMALS\BEARS.SPC, and RAYTRACE\MAC2RAY.GIF will be saved as
  716.          RAYTRACE\MAC2RAY.SPC.  Let's say you want to save all of the
  717.          ANIMALS pictures in another folder called NEWSTUFF.  To do
  718.          that, click on the "To" name for one of the animals pictures,
  719.          say, BEARS.GIF.  Move to the folder NEWSTUFF instead of
  720.          ANIMALS; then click on "Okay".  Now the "To" name is
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.                                                                 Page 12
  732.  
  733.          NEWSTUFF\BEARS.SPC.  The alert box will appear, asking you if
  734.          you want to change "All", "Match", or "None".  Select
  735.          "Match", and all the other ANIMALS pictures will be changed
  736.          to the NEWSTUFF folder.  Simple, huh?  If you'd chosen "All",
  737.          then all of the pictures (including the RAYTRACE ones) would
  738.          be saved in the NEWSTUFF folder.  "None" would save only
  739.          BEARS.SPC in the NEWSTUFF folder, since you had already
  740.          changed that one.
  741.  
  742.          Besides "Begin" and "Add", you'll see three other buttons in
  743.          the "Control" section of the dialog.  These are "Remove",
  744.          "Save", and "View".  "View" brings up a dialog, asking if you
  745.          want to view a single picture or the entire batch list.  If
  746.          you select "Single" then a fileselector will appear, allowing
  747.          you to choose a single picture to view.  Press any key to
  748.          return to the fileselector; select "Cancel" from the
  749.          fileselector to end viewing single pictures.  If you choose
  750.          to view the entire batch list, DMJ GIF will try to show you
  751.          the destination pictures in its batch list.  That way, if
  752.          you've just converted several pictures, you can quickly view
  753.          them all.  While viewing the pictures, use the left and right
  754.          arrow keys to set the direction (backwards or forwards,
  755.          respectively), Backspace to back up one picture, ESC or Undo
  756.          to end the slideshow, or any other key to advance to the next
  757.          picture.  There is no time delay, so pictures will not
  758.          advance until you decide to.  If you attempt to view an STe
  759.          picture while using an ST, DMJ GIF will "flicker" the colors
  760.          to simulate 3,375 of the STe's 4096 colors.  The "Remove"
  761.          button simply removes all of the skipped pictures from the
  762.          list.  That way you don't even have to have them in your
  763.          list.  And the "Save" button saves the list as a script file.
  764.          These script files should have an extension of .DGS (DMJ GIF
  765.          Script).  To load these script files back in, just click on
  766.          the "From" filename; you'll see the .DGS files appear in the
  767.          fileselector.  Just select one.
  768.  
  769.          In the "Options" section there is a button labeled "Skip".
  770.          "Skip" is a button that can be set for any of the pictures
  771.          you have in the list; if it is set, DMJ GIF will not convert
  772.          that picture, but will skip it.  This is useful if you have a
  773.          whole bunch of new pictures, and a few old pictures are in
  774.          the group.  You can just set the "Skip" button and DMJ GIF
  775.          won't spend any more time converting them.
  776.  
  777.          Once you're happy with all of the options for each picture,
  778.          just choose the "Begin" option, and DMJ GIF will go about its
  779.          business converting the pictures.  You can go watch a movie,
  780.          get some sleep, or have a bite to eat.
  781.  
  782.          If you stop a conversion and choose "Abort" from the alert
  783.          box, DMJ GIF will ask you if you want to abort the entire
  784.          batch.  Just choose "Yes" or "No"; "Yes" will stop the entire
  785.          conversion process and return you to the main dialog, and
  786.          "No" will proceed with the next picture.  (DMJ GIF will not
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.                                                                 Page 13
  798.  
  799.          ask you if it is already on the last picture, since that
  800.          would be pointless.)
  801.  
  802.          A note on the "Add" button: It is possible to add a file that
  803.          is already in the batch list.  That way you can convert the
  804.          same picture two different ways.  Future versions may check
  805.          for this and at least give a warning...
  806.  
  807.  
  808.          ST Resolution GIFs
  809.  
  810.          Sometimes you will find a GIF that precisely fits an ST
  811.          resolution. On such an occasion, DMJ GIF may suggest that you
  812.          convert it to an ST resolution image, instead of a Spectrum
  813.          picture.  (Some images, although they fit an ST resolution,
  814.          may have many similar colors in them, which would require
  815.          dithering to bring those colors out.  In these cases DMJ GIF
  816.          will suggest you convert to a Spectrum picture.) You can tell
  817.          when this happens by looking at the "To" filename after you
  818.          select the "Source" GIF.  If the extension is .SPC, DMJ GIF
  819.          is still suggesting a Spectrum picture.  But if it is .TNY,
  820.          then DMJ GIF suggests an ST resolution. You can also change
  821.          it to .PI1 or .PC1, the former being DEGAS uncompressed, and
  822.          the latter being DEGAS Elite Compressed.   DMJ GIF defaults
  823.          to Tiny format because it usually gives the smallest size
  824.          file.
  825.  
  826.          When using Mapping, you may find a situation where DMJ GIF
  827.          again suggests saving as an ST resolution picture.  Use
  828.          similar steps to change the file format.
  829.  
  830.          In some cases, you'll find DMJ GIF suggests an ST resolution
  831.          even when there are more colors than will fit in that
  832.          resolution.  That's because DMJ GIF has analyzed the palette,
  833.          and determined that those colors can be accurately
  834.          represented by dithering the other colors.  This doesn't
  835.          happen very often, though.
  836.  
  837.  
  838.          Conversion Types
  839.  
  840.          In the "Options" section of the main dialog you will find an
  841.          inconspicuous button labeled "Type".  This seemingly innocent
  842.          button hides some very powerful options.
  843.  
  844.          Basically, this button lets you choose what kind of
  845.          conversion you want done.  There are only three types of
  846.          conversion currently available: Full Color, Grey Scale, and
  847.          Monochrome.  Full color converts the entire picture to a
  848.          color image; Grey Scale converts the picture to a grey image;
  849.          and Monochrome converts the picture to a monochrome image.
  850.          DMJ GIF will automatically select whichever type of
  851.          conversion is "best" for the GIF, but you can override it if
  852.          you like.  Also note that next to each button ("Full Color",
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.                                                                 Page 14
  864.  
  865.          "Grey Scale", and "Monochrome") is a list of valid
  866.          extensions.  DMJ GIF will not allow you to use any extension
  867.          for the destination file other than those listed next to the
  868.          selected conversion type.
  869.  
  870.  
  871.          Dithering
  872.  
  873.          "Dithering" is mixing two colors to get a third.  In DMJ GIF,
  874.          it specifically means the mixing of two very similar colors
  875.          to make it look like a more precise shade--one that isn't
  876.          possible with the ST's palette of 512 colors.
  877.  
  878.          DMJ GIF has five dithering modes; DMJ GIF will make its best
  879.          guess as to which dither mode to use.  This guess is based on
  880.          which palette you have asked for (the ST's 512 or the STe's
  881.          4096), how similar the colors in the original GIF are, and
  882.          how much scaling is being done on the picture.  To set the
  883.          dither mode you want to use, just click on one of the five
  884.          dither buttons in the "Options" section of the main dialog.
  885.  
  886.          You want to use as little dithering as possible, since
  887.          dithering has the effect of "fuzzing" edges.  DMJ GIF will
  888.          automatically set whichever dither mode it thinks is best for
  889.          the current GIF, so you shouldn't have to set this often.
  890.          Also, the more dithering you want to use, the larger the area
  891.          of the color you need to be able to see the color detail.
  892.          And the biggest reason to use as little dithering as possible
  893.          is time.  The more dithering, the more time it takes.  Level
  894.          5 is the exception, because it uses a different technique
  895.          than levels 1-4.  Level 5 is about as fast as Level 3.  But
  896.          you should never use level 5 on a color conversion; it just
  897.          doesn't produce very good pictures.  You should only use
  898.          level 5 for grey-scale conversions.
  899.  
  900.          If you change either the palette or the scaling factors,
  901.          click on the word "Dither" and DMJ GIF will re-analyze the
  902.          information and set the "best" dither mode.
  903.  
  904.  
  905.          Palettes
  906.  
  907.          DMJ GIF will, if you choose, use the STe's palette of 4,096
  908.          colors.  This gives you much greater precision in color,
  909.          without having to use as much dithering.
  910.  
  911.          There are four palette buttons in the "Options" section.  Two
  912.          are labeled "Current Palette", and two are labeled "Default
  913.          Palette".  Each pair has an "ST" button and an "STe" button.
  914.          The "Current Palette" buttons affect only the picture
  915.          currently selected; they are set to whatever is selected in
  916.          the "Default" pair when that picture is first analyzed.  If
  917.          you change the "Default" pair, DMJ GIF will ask you if you
  918.          want to change all the pictures in the batch list.  Answering
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.                                                                 Page 15
  930.  
  931.          "No" to this question does not cancel your choice of default
  932.          palette; it just doesn't change any pictures already
  933.          analyzed.
  934.  
  935.          Using the STe's palette does not always bring better results.
  936.          In some 256-color pictures, there is already more color than
  937.          can be fit on one Spectrum line.  By increasing the palette,
  938.          you are only increasing the number of colors that should be
  939.          on each line.  This can make the "streaking" problem worse.
  940.          If you get an STe picture with severe "streaking", use the ST
  941.          palette.
  942.  
  943.          ST users are probably wondering why they would want to make
  944.          an STe picture they can't see.  DMJ GIF comes with a program
  945.          to let you see the STe pictures on a regular ST.  It is able
  946.          to simulate 3,375 of the STe's 4,096 colors.  DMJ GIF's
  947.          "View" feature also performs this emulation.  You can display
  948.          STe Spectrum pictures with any Spectrum picture viewer, but
  949.          you won't see the extra colors unless you're using an STe.
  950.  
  951.  
  952.          Scaling
  953.  
  954.          As stated in the introduction, many GIF pictures are larger
  955.          than the ST's 320x200 low resolution.  This means a picture
  956.          must be scaled, or reduced, to fit on the Spectrum screen.
  957.          Unlike some programs that require the picture to be reduced
  958.          the same amount both vertically and horizontally, DMJ GIF
  959.          reduces each axis separately.  And DMJ GIF does not require
  960.          you to use whole numbers, like 1, 2, and 3.  You can use
  961.          fractional values, like 1.5 or 2.4.
  962.  
  963.          Here's some examples.  Let's say you're converting the file
  964.          that comes with DMJ GIF, EXAMPLE.GIF.  This picture is
  965.          640x400.  This gives an X (horizontal) reduction factor of 2,
  966.          and a Y (vertical) reduction factor of 2.  The reduction
  967.          values are figured by taking the GIF's size and dividing it
  968.          by the Spectrum picture's size.  So 640/320=2, which is the X
  969.          reduction factor; 400/200=2, which is the Y reduction
  970.          factor.
  971.  
  972.          Soon you'll find a Super VGA GIF, which is 640x480.  The X
  973.          reduction factor in this case is still 2, but the Y reduction
  974.          factor is 2.4, because 480/200=2.4.  Remember that it's okay
  975.          to use fractional values.
  976.  
  977.          I'm sure you've noticed that DMJ GIF automatically calculates
  978.          the reduction factors for you.  But if you convert an EGA
  979.          GIF, which is 640x350, you'll notice that DMJ GIF suggests a
  980.          Y reduction factor of 2.  What's the deal?  350/200=1.75, not
  981.          2.  The reason is that EGA pictures of the 640x350 type look
  982.          stretched when a Y reduction factor of 1.75 is used.  So
  983.          after trying several other factors, I settled on 2 as a
  984.          reasonable value.  DMJ GIF recognizes some other resolutions
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.                                                                 Page 16
  996.  
  997.          and also calculates "best guesses" to those pictures.
  998.  
  999.          Most of the time DMJ GIF suggests the best reduction factors
  1000.          for the GIF.  But sometimes you may want to use different
  1001.          reduction factors (more on why in a bit).  To change the
  1002.          factors, just move the cursor with the arrow keys until it is
  1003.          after the scaling factor you want to change.  You can use ESC
  1004.          to erase the current number, and then enter a new one.
  1005.          (BACKSPACE and DELETE also work.)  If you leave one of these
  1006.          factors blank, DMJ GIF will "Guess" the proper scaling
  1007.          factors.
  1008.  
  1009.          One reason to change the reduction factors might be if you
  1010.          were trying to create a special effect.  But a more common
  1011.          reason is that the picture looks squashed, and you want to
  1012.          try to correct that.  As stated above, a Super VGA GIF has
  1013.          reduction factors of 2 and 2.4.  Occasionally a picture will
  1014.          appear squashed, because the aspect ratio is different.  (The
  1015.          aspect ratio is the ratio between a pixel's width and its
  1016.          height.)  If you convert a Super VGA GIF, and it appears
  1017.          squashed, try reduction factors of 3 and 3.  This will
  1018.          maintain the aspect ratio, while still getting a fairly large
  1019.          picture.
  1020.  
  1021.          Now you're probably wondering why I didn't suggest just using
  1022.          2.4 and 2.4.  The reason is that when you use fractional
  1023.          factors, the number of colors increases dramatically, because
  1024.          you end up with a lot of fractional colors at the edges of
  1025.          solid areas.  For Y factors, it's no problem, since one
  1026.          Spectrum line has no affect on any other.  But you should try
  1027.          (if possible) to keep the X factors as whole numbers, since
  1028.          Spectrum only permits 42 colors per line, and all those
  1029.          fractional colors wouldn't come out properly...
  1030.  
  1031.          Here's where the "Guess" and "Exact" buttons are used.  If
  1032.          you've changed the scaling factors and want to reset them,
  1033.          the "Guess" button can be used to have DMJ GIF provide its
  1034.          best guess at the scaling factors (the same guess as first
  1035.          provided).  The "Exact" button provides the exact scaling
  1036.          factors; it bypasses the "best guess" part (so EGA 640x350
  1037.          GIFs are scaled 2x1.75).
  1038.  
  1039.  
  1040.          Mapping
  1041.  
  1042.          This is one of the most sophisticated options in DMJ GIF.
  1043.          What it does is allow you to choose exactly what part of the
  1044.          GIF you want to convert to Spectrum format.
  1045.  
  1046.          To use Mapping, you must have first converted the picture
  1047.          normally.  Since you wouldn't know you didn't want the whole
  1048.          image unless you'd already converted the picture, this
  1049.          shouldn't be a problem.  Select the original GIF as the
  1050.          "From" file; then click on the "Map" button in the lower left
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.                                                                 Page 17
  1062.  
  1063.          hand corner of the main dialog.  You will be prompted to
  1064.          select the "Map" picture.  This is the entire picture as it
  1065.          was originally converted.  Here's an example: if you
  1066.          converted EXAMPLE.GIF and got EXAMPLE.SPC, then when you want
  1067.          to selectively convert the same picture, EXAMPLE.GIF would be
  1068.          the "Source", and EXAMPLE.SPC would be the "Map".  It is
  1069.          extremely important that you used the reduction factors
  1070.          suggested by DMJ GIF in this "Map" picture, or you won't get
  1071.          the part you expected to get!
  1072.  
  1073.          Once you've selected the Map picture, you'll see it appear on
  1074.          the screen.  (If you selected a Spectrum picture as the Map,
  1075.          DMJ GIF will first convert it to a grey scale image.  This
  1076.          takes about ninety seconds.)  Now you'll see some crosshairs
  1077.          on the screen.  What you must do now is select the portion of
  1078.          the picture you want to convert.  Move the crosshairs with
  1079.          the mouse to one corner of the part you want, and click the
  1080.          left mouse button.  Then move the crosshairs to the opposite
  1081.          corner and press the left mouse button.  The portion of the
  1082.          picture that is enclosed in the rectangle between the
  1083.          crosshairs is what will appear in the final picture.  If you
  1084.          press the right mouse button after selecting one corner
  1085.          point, that corner point will disappear, allowing you to
  1086.          choose it again.  If you press the right mouse button with no
  1087.          corner points selected, you will abort the Mapping
  1088.          procedure.
  1089.  
  1090.          After selecting the portion of the GIF you want to convert,
  1091.          you will be presented with a dialog containing two options.
  1092.          The first is "Same Aspect".  If this is set, DMJ GIF will
  1093.          convert the portion you requested, but will keep the same
  1094.          proportions as the map picture.  If this is not set, DMJ GIF
  1095.          will convert the portion you requested, scaling it to
  1096.          precisely fill the entire screen.  This is useful for
  1097.          creating squashed or squeezed pictures, or when the original
  1098.          image was a bit squashed or squeezed and you want to fix it.
  1099.          The second option, "Trim Edges", applies only if "Same
  1100.          Aspect" is set.  If you keep the proportions the same, there
  1101.          will be areas around the converted picture that are not in
  1102.          the selected portion of the image.  If you select "Trim
  1103.          Edges", these areas will appear black.  If this option is not
  1104.          set, these areas will contain more of the original image.
  1105.          (This may mean shifting the selected portion of the picture
  1106.          off-center to prevent going over the edge of the GIF.)
  1107.          Select "Okay" when you're done setting these options.
  1108.  
  1109.          Once Mapping is set, you can change it by clicking on the
  1110.          "Map" button again.  You will be asked if you want to change
  1111.          the selected portion or if you want to disable Mapping.
  1112.          (Note: if you converted a picture or selected another Map
  1113.          picture, you will have to reload the Map picture.)
  1114.  
  1115.          If you have selected Mapping, you should NOT change the
  1116.          scaling factors yourself!  If you do, you won't get the
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.                                                                 Page 18
  1128.  
  1129.          picture you think you're getting.  Use the "Exact" and
  1130.          "Guess" buttons to reset the scaling factors.
  1131.  
  1132.  
  1133.          Interlaced GIFs
  1134.  
  1135.          Occasionally you will find a GIF that is interlaced--that is,
  1136.          the picture isn't stored so that lines next to each other on
  1137.          the screen are next to each other in the file.  This is
  1138.          inconvenient for DMJ GIF, since it needs to process the lines
  1139.          from top to bottom.  So what DMJ GIF does is Uncompress the
  1140.          entire picture and then Scale it.  Some pictures are too big
  1141.          to fit in memory.  If this happens, DMJ GIF will write the
  1142.          picture, uncompressed, to the disk.  This takes longer, but
  1143.          it's better than not being able to convert the picture at
  1144.          all.  (This also consumes an enormous amount of disk space;
  1145.          let's hope that nobody creates an interlaced GIF that
  1146.          uncompresses to 2 Meg!)
  1147.  
  1148.  
  1149.          Keyboard Shortcuts
  1150.  
  1151.          DMJ GIF does have some keyboard shortcuts to buttons in the
  1152.          main dialog.  Here they are:
  1153.  
  1154.                Help         "Help"
  1155.                I            "Info"
  1156.                Undo         "Quit"
  1157.                F            "From"
  1158.                T            "To"
  1159.                Return       "Begin"
  1160.                A            "Add"
  1161.                R            "Remove"
  1162.                S            "Save"
  1163.                V            "View"
  1164.                D            "Dither"
  1165.                F1-F5        Dither "1"-"5"
  1166.                F7           Current Palette "ST"
  1167.                F8           Current Palette "STe"
  1168.                F9           Default Palette "ST"
  1169.                F10          Default Palette "STe"
  1170.                P            "Map"
  1171.                G            "Guess"
  1172.                E            "Exact"
  1173.                Y            "Type"
  1174.                K            "Skip"
  1175.                ?            "Prefs"
  1176.                M            "More"
  1177.  
  1178.          All of these are in lower case.
  1179.  
  1180.          There are also some other keypresses that can be used
  1181.          elsewhere:
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.                                                                 Page 19
  1194.  
  1195.          o In any "Yes"/"No" alert box, Return is "Yes" and Undo is
  1196.            "No".
  1197.          o In the "Abort Conversion" alert box, Return is "Abort", P
  1198.            is "Peek", and Undo is "Cancel".
  1199.          o In the fileselector, Return is "Okay", Undo is "Cancel",
  1200.            and Tab brings up the search mask dialog.
  1201.          o In any disk error dialog, Return is "Retry" and Undo is
  1202.            "Cancel".
  1203.          o In any situation where you have "Abort" or "Cancel", Return
  1204.            is "Abort" and Undo is "Cancel".
  1205.  
  1206.  
  1207.          Preferences
  1208.  
  1209.          This button allows you to set some of the defaults used by
  1210.          DMJ GIF.  There are four things that you can set in this
  1211.          dialog: what to do about existing destination files, the
  1212.          default palette when loading, whether to use the ST or STe
  1213.          palette inside the program, and which drive to use for the
  1214.          temporary file.
  1215.  
  1216.          "Existing Files" allows you to set what you'd like to do
  1217.          about files that already exist when DMJ GIF tries to save a
  1218.          picture (i.e. you want to save BEARS.SPC, and there's already
  1219.          a BEARS.SPC on the disk).  "Erase" will simply overwrite the
  1220.          old file, destroying it.  "Rename" will rename it with the
  1221.          extension ".BAK", destroying any existing backup, but
  1222.          preserving the existing file.  "Ask", the default, will have
  1223.          DMJ GIF ask you which option to choose every time the
  1224.          situation occurs.  If you plan to leave DMJ GIF to work
  1225.          unattended, you should select "Erase" or "Rename"; otherwise,
  1226.          DMJ GIF will stop its work to ask you what to do about an
  1227.          existing file, and you won't be around...
  1228.  
  1229.          "Default Palette" refers to the "Default Palette" buttons in
  1230.          the main dialog.  The default is "Check", which means DMJ GIF
  1231.          will check whichever system it is running on and use the
  1232.          palette for that system.  You can override this feature by
  1233.          selecting "ST" or "STe"; this option is only acted upon when
  1234.          the program first loads up.  (Owners of 4096 color boards for
  1235.          the ST can use this to set the STe palette to always be the
  1236.          default.)
  1237.  
  1238.          "In-program Palette" refers to which palette the program uses
  1239.          to display pictures.  Again, the default is "Check".  If DMJ
  1240.          GIF uses the ST palette, it will flicker STe color images to
  1241.          simulate the STe colors.  Also, when converting Spectrum
  1242.          pictures to grey Map pictures, it will only use eight shades
  1243.          of grey.  If DMJ GIF uses the STe palette, however, it will
  1244.          not flicker STe color images, and will use sixteen shades of
  1245.          grey for Map pictures.
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.                                                                 Page 20
  1258.  
  1259.          "Temp Drive" allows you to choose the drive DMJ GIF will
  1260.          write temporary files to.  This is only important for
  1261.          interlaced pictures that are too large to uncompress to RAM;
  1262.          DMJ GIF then writes the uncompressed picture to disk.  To
  1263.          select the drive for this temporary file, just click on the
  1264.          drive letter.  The default is "Run", which refers to the
  1265.          drive DMJ GIF was run from.  If the specified drive does not
  1266.          exist, DMJ GIF will revert to the "Run" drive.
  1267.  
  1268.          Once you've set your Preferences, you can click on "Save" to
  1269.          save these preferences to DMJ_GIF3.PRF.  If you save your
  1270.          preferences, you also save the positions of the movable
  1271.          dialogs (the fileselector, search mask dialog, etc.) and all
  1272.          of the search masks in the search mask dialog.  You can click
  1273.          on "Use" to keep the preferences without saving them.
  1274.          "Cancel" aborts your choices.
  1275.  
  1276.  
  1277.          Bugs
  1278.  
  1279.          Wrong?  How could anything possibly go wrong?  Not with MY
  1280.          program, surely!
  1281.  
  1282.          Well, okay, perhaps just a little tiny thing went wrong.
  1283.          It's probably nothing major.  DMJ GIF will, for the most
  1284.          part, tell you precisely what it is having a problem with.
  1285.          But if for some reason you get a dialog that tells you
  1286.          something like "Error xxx" then that's a bug.  And when you
  1287.          find one, it's pretty important that you write down as much
  1288.          information about what you're doing, which GIF you're using,
  1289.          and any other programs and accessories you might have loaded
  1290.          at the time.  Then let me know!  I can't fix a bug if nobody
  1291.          tells me about it.  I've tested DMJ GIF as best I could, on
  1292.          both 1 Meg and 512K machines, with a variety of AUTO folder
  1293.          programs, etc. but it's always possible that something can go
  1294.          wrong.
  1295.  
  1296.          There are some things that you can solve yourself.  One very
  1297.          common glitch is that you'll see little specks (usually
  1298.          black) in your Spectrum pictures, and they'll usually form a
  1299.          sort of vertical line.  This isn't my fault!  What's
  1300.          happening is that the Spectrum display routines aren't
  1301.          properly synchronized.  Usually all you have to do is reset
  1302.          the computer.  I'd suggest actually pressing the reset button
  1303.          or turning the computer off; using another program to reset
  1304.          the computer usually doesn't cure the problem.  If you still
  1305.          see the spots, try changing the order of the programs in your
  1306.          AUTO folder--one of them may be the culprit.  If you have an
  1307.          STe, try switching to low resolution.  Spectrum pictures from
  1308.          other programs are also susceptible to this little annoyance,
  1309.          but the pictures generated by DMJ GIF are much more
  1310.          susceptible because DMJ GIF squeezes every bit of color it
  1311.          can out of Spectrum mode.  Fortunately this sync problem
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.                                                                 Page 21
  1323.  
  1324.          doesn't occur too often on most machines.
  1325.  
  1326.          If you should chance to fill up the disk while trying to save
  1327.          a picture, DMJ GIF will tell you the disk is full, and ask
  1328.          that you insert a fresh disk.  At this point, you should
  1329.          either insert a new disk and select "Retry" or decide to
  1330.          forget the whole thing and select "Cancel".  If you select
  1331.          "Retry", DMJ GIF will save the picture in the root directory
  1332.          of the disk (NOT the folder specified in the "To" filename).
  1333.          I'd suggest at this point that you abort further conversions,
  1334.          remove all files from the batch list that have been
  1335.          converted, and either relocate the pictures to the root
  1336.          directory or save the batch list, exit the program, create
  1337.          the necessary folders, and reload the program and batch list
  1338.          and begin again.  Future versions of DMJ GIF may be a bit
  1339.          nicer in this respect...
  1340.  
  1341.          Users of the Mega STe will obviously not be able to see
  1342.          Spectrum pictures while running at 16 MHz; however, once the
  1343.          computer is slowed down to 8 MHz the pictures display
  1344.          properly.  It's best to leave the computer in 16 MHz mode
  1345.          while converting pictures, though, because conversion is a
  1346.          time-consuming process.  I am told that using DMJ GIF 2.0, a
  1347.          GIF converts in about 2/5 the time as on a regular ST.  I
  1348.          have no information on version 3.0 yet.
  1349.  
  1350.  
  1351.          Feedback
  1352.  
  1353.          It's extremely important that you, as a user, tell me what
  1354.          you want in the program!  Granted, I can come up with some
  1355.          very clever ideas, but the best ideas come from people who
  1356.          know absolutely nothing about what can and can't be feasibly
  1357.          done, which gets programmers thinking about how it can be
  1358.          done.  (The above is said with a smile.)  Seriously, though,
  1359.          user feedback is critical to the improvement of any program;
  1360.          after all, the users are the ones who use the program.  So if
  1361.          you have a comment, a suggestion, or if there something you
  1362.          don't like about the program, then PLEASE let me know!  As an
  1363.          example of how important feedback is, let me say that letters
  1364.          from one of my (very enthusiastic) registered users hastened
  1365.          the design of the new interface by posing some very important
  1366.          questions.  Had that person not asked the questions he did
  1367.          (about Mapping and STe palette) I might not have noticed
  1368.          several flaws in my design until it was too late.
  1369.  
  1370.  
  1371.          The Companion Utilities
  1372.  
  1373.          In addition to DMJ GIF, there are four companion utilities
  1374.          that perform a variety of useful functions.  Here's a list of
  1375.          what they are and how to use them:
  1376.  
  1377.          SPC2PI1
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.                                                                 Page 22
  1390.  
  1391.          This simple program converts Spectrum pictures to DEGAS low
  1392.          res (.PI1) format.  It's useful when you get a Spectrum
  1393.          picture that has 16 or fewer colors, or when you need a low
  1394.          res approximation of a Spectrum picture.
  1395.  
  1396.          To use this program, just select the source and destination
  1397.          file.  The source may be in compressed (.SPC) or uncompressed
  1398.          (.SPU) format.  The destination filename should end in .PI1,
  1399.          of course.  You'll find that the program keeps track of two
  1400.          separate paths--one for the source pictures, and one for the
  1401.          destination pictures.  You'll be warned if the source and
  1402.          destination files are the same, or if you try to overwrite an
  1403.          existing file.
  1404.  
  1405.          After selecting both the source and the destination file, the
  1406.          picture will load and display on the screen.  Press any key
  1407.          to continue with the conversion, or ESC to abort.  You can
  1408.          press ESC at ANY time to abort the conversion.  The first
  1409.          phase of the conversion takes approximately 75 seconds, and
  1410.          is just a color count.  When that is finished, the program
  1411.          will tell you how many colors were in the original picture,
  1412.          and the percentage of the picture that is covered by the 16
  1413.          colors chosen.  The higher the percentage, the more the DEGAS
  1414.          picture will look like the Spectrum picture.  Once the
  1415.          picture is converted, it will be saved, and you will be asked
  1416.          if you want to delete the source picture.
  1417.  
  1418.          This program does recognize and use the STe palette,
  1419.          regardless of which computer you are actually using.  If you
  1420.          are converting an STe Spectrum picture and plan to view it on
  1421.          an ST, be aware that you may get two colors that appear the
  1422.          same on an ST, but are actually different.  In this case just
  1423.          load the picture into your favorite paint program and tinker
  1424.          with the palette until it's how you like it.
  1425.  
  1426.          After converting one picture, you can select another picture
  1427.          to convert, or select "Cancel" from the first file selector
  1428.          to exit the program.
  1429.  
  1430.          SPC2PI3
  1431.  
  1432.          This program and SPU2SPC are the only two companion utilities
  1433.          that will run on a monochrome monitor.  This program is like
  1434.          SPC2PI1, except that it converts a Spectrum picture to a
  1435.          DEGAS high-resolution format.  This is one way to get a
  1436.          black-and-white version of a Spectrum picture.
  1437.  
  1438.          You use this program just like SPC2PI1, except the extension
  1439.          for the destination file should be .PI3.  Once the picture is
  1440.          loaded, it will be displayed, unless you are using a
  1441.          monochrome monitor (obviously).  Press a key to continue with
  1442.          the conversion.
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.                                                                 Page 23
  1455.  
  1456.          If you have the original GIF that created the Spectrum
  1457.          picture, it's probably a better idea to use DMJ GIF to
  1458.          re-convert the original GIF, either to a 16-color image in
  1459.          color or a monochrome image.  These programs were included to
  1460.          convert Spectrum pictures when you didn't have the original
  1461.          GIF, and do not do quite as good a job as DMJ GIF does.
  1462.  
  1463.          SPU2SPC
  1464.  
  1465.          This program does nothing but load and save the picture.  It
  1466.          does not change the picture in any way.  The idea behind the
  1467.          program is to provide you an easy way of converting
  1468.          uncompressed (.SPU) Spectrum pictures to compressed (.SPC)
  1469.          format, and vice versa.  You use this program in the same way
  1470.          as SPC2PI1, except that the picture will not be displayed,
  1471.          and the destination file should end in either .SPC or .SPU.
  1472.  
  1473.          Sometimes you might find a Spectrum (.SPC) picture that is
  1474.          50014 bytes long.  These pictures are not compressed fully;
  1475.          you should use SPU2SPC to re-save them in .SPC format.
  1476.  
  1477.          SPC-3375
  1478.  
  1479.          This is a slideshower/picture viewer that lets you see 3,375
  1480.          of the STe's 4,096 colors on a regular ST.  Just run the
  1481.          program, and either select a single picture (which will then
  1482.          be displayed) or a wildcard (like *.*) to begin a slideshow.
  1483.          While running a slideshow, you can use the function keys to
  1484.          set the speed, press the spacebar to freeze the picture, or
  1485.          any other key to advance to the next picture, except the ESC
  1486.          and UNDO keys, which abort the show.  Select "Cancel" from
  1487.          the file selector to exit the program.
  1488.  
  1489.          SPC-3375 emulates the STe's colors by "flickering" the colors
  1490.          between a lighter shade and a darker shade.  The eye is
  1491.          fooled into seeing a shade that is halfway between the two
  1492.          shades.  Since the flickering isn't quite as fast as the
  1493.          monitor (it's only half as fast) you will see some visible
  1494.          flickering.  This is reduced by using lighter and darker
  1495.          shades every other line, then swapping them to do the
  1496.          flicker.  Don't stare too closely at the screen, though,
  1497.          because then the flicker effect is wasted.
  1498.  
  1499.          Those of you who don't have a monitor--well, the flickering
  1500.          is extremely bad on a television.  Enough so that I wondered
  1501.          at a user who told me he always used the STe palette, even
  1502.          though he has only an ST.  Then I got my monitor, and I knew
  1503.          why!  The flickering is only half as bad on a monitor as it
  1504.          is on a TV.
  1505.  
  1506.  
  1507.          Thanks...
  1508.  
  1509.          A program this complex cannot be done without the help of
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.                                                                 Page 24
  1521.  
  1522.          others.  Thanks to all these people for their help in getting
  1523.          this program going.
  1524.  
  1525.          Robert and Eric Swenson, of Novato, CA, for introducing me to
  1526.          the ST and convincing me not to buy an Amiga.
  1527.  
  1528.          Robert Glover, of Stuart, FL, for finally getting me the
  1529.          Spectrum display routine, and for all of his dedicated
  1530.          testing.
  1531.  
  1532.          Marc Lombardo, of Ralston, NE, for being there when I felt
  1533.          like talking my head (and his ear) off with awesome program
  1534.          ideas.
  1535.  
  1536.          Bryan Woodworth, of San Jose, CA, for making all those
  1537.          excellent suggestions--most of which are in version 3.0--and
  1538.          for asking pointed questions about the new version.
  1539.  
  1540.          Tom Hayslett, of Vogelweh, Germany, for sage advice, a ride
  1541.          up to Düsseldorf, and a fantastic manual.
  1542.  
  1543.          All of my registered users--that check in the mail makes it
  1544.          all worth it.
  1545.